home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / hardware / mousev1b.lzh / MouseV1.PKG / AMIGA.UTL / SerMou20 / SerMouse.Doc next >
Text File  |  1980-02-13  |  9KB  |  242 lines
  1. $VER: SerMouse 2.20, serial mouse package (+driver) for PC mice.
  2.  
  3.  
  4. Welcome to:
  5.  
  6.  
  7.  
  8.                      \                |              /
  9.  
  10.                    -   The ultimate PC-Mouse package   -
  11.  
  12.                      /                |              \
  13.  
  14.  
  15.  
  16. A lot of people don't like the standard Amiga mouse (and I don't blame 'm).
  17. And if they do like him (I like to 'personalize' my mouse) he (she?) dies
  18. within a short period of time. The market for specific Amiga mice is very
  19. small. Most people like the PC mice and trackballs. I 'm using a PC mouse
  20. of Q-tec, after my Amiga mouse died some years ago. To make it a bit easier
  21. for people to use PC mice and trackballs on the Amiga, I decided to write
  22. this packadge for the use of PC-mice on the Amiga. It contains the
  23. following things (in this doc or the archive):
  24.  
  25.  * A serial mouse driver for both Microsoft mice and Mouse System mice.
  26.  
  27.  * A description for converting 9-pin Sub-D serial to 25-pin serial.
  28.  
  29.  * A description for converting 9-pin Sub-D BUS-mouse to 9-pin Amiga
  30.    mouse.
  31.  
  32.  * A description for converting 9-pin Mini-Din BUS-mouse to 9-pin Amiga
  33.    mouse.
  34.  
  35.  
  36.  
  37. The SerialMouse-driver
  38. ----------------------
  39.  
  40. The SerialMouse-driver is called "SerMouse" and should be included in this
  41. package. It can only be used with Kickstart version 2.0 or above. The
  42. current version is 2.20. You can start it from the command-line by typing
  43. "SerMouse" or from the WorkBench by double-clicking on it's icon. To
  44. deactivate it, just restart the program. If you want to activate it every
  45. time your computer is switched on, add the command in your s:user-startup
  46. or drag the icon to the WBStartup drawer (do not remove the DONOTWAIT
  47. tooltype!).
  48.  
  49. You can specify the following things either as command-line argument or as
  50. icon tooltype:
  51.  
  52.  
  53. 3BYTES or 5BYTES
  54.  
  55. This indicates the mouse-type you're using. 5BYTES is the default and most
  56. used type. If you've got a 3-button mouse, it's deffenetely a 5BYTES type.
  57. If the mouse doesn't work, just try the other type... I named the types
  58. by the number of bytes they sent for one event.
  59.  
  60.  
  61. DEVICE
  62.  
  63. The device to be used for reading serial data. Default is the
  64. serial.device. SerMouse has been tested with the VECTOR Connection multi
  65. I/O card and it worked without any problems.
  66.  
  67.  
  68. UNIT
  69.  
  70. The device-unit to be used for reading serial data. Default is unit 0.
  71. Also tested with the VECTOR board.
  72.  
  73.  
  74. PRIORITY
  75.  
  76. This is the task-priority of the mouse-driver. The default is 20. This
  77. should be OK. It's the same priority as the input.device eg. the standard
  78. mouse.
  79.  
  80.  
  81. The program SerMouse is (c) by me (K.P. van Beem) and is distributed as
  82. FreeWare. This means, you may freely use and distribute it, as long as the
  83. programm and this documentation is left unchanged. The source of the
  84. programm is available as GiftWare. Contact me if you're interested in it.
  85. It's partly C and partly assembler.
  86.  
  87. Be sure pin 22 of the serial-port is NOT connected to any line of the
  88. mouse when you use a serial mouse. This will interfere with your parallel
  89. port.
  90.  
  91.  
  92.  
  93. Converting 9-pin Sub-D serial to 25-pin serial
  94. ----------------------------------------------
  95.  
  96. Most serial mice do have a 9-pin Sub-D serial connector (that's the two-row
  97. connector, NOT a din!). The Amiga has a 25-pin serial connector. In most
  98. stores, you can by adapters from 9 to 25 pins. For those who want to build
  99. them in stead of by them, or just want to connect a 25-pin connector
  100. directly to the wire, this is how you should connect it (the pin-numbers
  101. are normally written on the connectors):
  102.  
  103.  
  104.   9-pin           25-pin
  105.   D-Sub           D-Sub
  106.  
  107.     1       <==>     8          Carrier Detect
  108.     2       <==>     3          Recieve
  109.     3       <==>     2          Transmit
  110.     4       <==>    20          Data Terminal Ready
  111.     5       <==>     7          Signal Ground
  112.     6       <==>     6          Data Set Ready
  113.     7       <==>     4          Request To Send
  114.     8       <==>     5          Clear To Send
  115.  
  116. Do NOT connect pin 22 on the Amiga side (with pin 9 on the mouse side).
  117. This will interfere with the parallel port of your Amiga. This line is the
  118. Ring Indicator which is only used by modems (and most of the time not by
  119. Amiga software).
  120.  
  121. And don't forget the shield-ground.
  122.  
  123.  
  124.  
  125. Converting 9-pin Sub-D BUS-mouse to 9-pin Amiga mouse
  126. -----------------------------------------------------
  127.  
  128. Besides serial mice, there's an other type of mouse that is used for the
  129. PC. Although not often these days. It's called the BUS-mouse. It's basicly
  130. the same mouse as the Amiga (and the Atari) is using, but differently
  131. wired. You can easily rewire the mouse (or make an adapter) and connect the
  132. mouse on the mouse-port of the Amiga, just like you do with your standard
  133. Amiga mouse. This way, you can use this type of mouse without a separate
  134. driver. This is the way I use my PC mouse on the Amiga. You should rewire
  135. the mouse as described below:
  136.  
  137.      Amiga side            Mouse side
  138.        D-Sub                  D-Sub
  139.  
  140.      5 4 3 2 1             5 4 3 2 1
  141.       9 8 7 6               9 8 7 6
  142.  
  143.         1         <==>          4       Vertical pulse
  144.         2         <==>          1       Horizontal pulse
  145.         3         <==>          3       Vertical pulse Qualifier
  146.         4         <==>          2       Horizontal pulse Qualifier
  147.         5         <==>          5       Midle button
  148.         6         <==>          6       Left button
  149.         7         <==>          7       +5V
  150.         8         <==>          8       Ground
  151.         9         <==>          9       Right button
  152.  
  153.  
  154.  
  155. Converting 9-pin Mini-Din BUS-mouse to 9-pin Amiga mouse
  156. --------------------------------------------------------
  157.  
  158. For a description of the BUS mouse, see above. Besides the Sub-D plug, most
  159. modern computers do have a mini-Din to connect the bus-mouse to the
  160. computer. Of cause, these can also be rewired. Belose is described how. I
  161. haven't tested this, but I took it from a German magazin.
  162.  
  163.     Mouse          Amiga
  164.    Mini-DIN        D-SUB
  165.  
  166.       1     <==>     7      +5V
  167.       2     <==>     2      Horizontal pulse
  168.       3     <==>     4      Horizontal pulse Qualifier
  169.       4     <==>     1      Vertical pulse
  170.       5     <==>     3      Vertical pulse Qualifier
  171.       6     <==>     6      Left button
  172.       7     <==>     5      Middle button
  173.       8     <==>     9      Right button
  174.       9     <==>     8      GND
  175.  
  176. I'm not sure the pin-nubers are written on the Mini-Din, besides, if you
  177. don't make an adapter but just rewire it, you won't have the bus. So I'l
  178. give the numbers here. You are looking at the soldier side of the bus, so
  179. at the pin-side of the plug!
  180.  
  181.                   |__|
  182.  
  183.                 7   8  9
  184.                3  4  5  6
  185.               __ 1   2  __
  186.                 |      |
  187.  
  188.  
  189.  
  190. Changes since 2.00
  191. ------------------
  192.  
  193. * Added the warning in the docs about pin 22 (ring indicator). This pin
  194.   should NOT be connected. With some mice, it interacts with the printer
  195.   in such a way that you won't be able to print while the mouse in
  196.   connected.
  197. * Some mouse-actions involving clicking with the mouse-buttons didn't work
  198.   as they should. This included console-clipping, drag-selecting in some
  199.   programs, double-click and other combinations in YAK and using PowerSnap.
  200.   This was partly coused by the input.device. It doesn't update the current
  201.   state of the buttons the way I tell it to do. In order to work around
  202.   this, I had to use some undocumented 'features' of the input.device. But
  203.   don't fear. It's proven to work safe on all OS versions released up till
  204.   now. Now the serialmouse-driver realy works as the 'normal' mouse!
  205.  
  206.  
  207. Credits
  208. -------
  209.  
  210. I want to thank the following people (in alphabetical order) who helped me
  211. with this mice stuff:
  212.  
  213. Marcel Duyn, who lent me a serial mouse for testing the driver (correction
  214. as for version 2.20: I now bought it :-)) )
  215. Carsten Gerlach for finding out the couse of the serialmouse driver not
  216. working with commodities like Yak and PowerSnap. (Myself for finding the
  217. optimum solution :-)) )
  218. Stefan Johannesdal, who tested the 5BYTES part of the driver.
  219. Patrick Smith for letting me know some serial-mice do have pin 22 connected.
  220. Christian Stieber, who provided me with some technical info about the
  221. 5BYTES serial mouse protocol.
  222.  
  223. For questions, suggestions or bug-reports, you can always reach me at the
  224. adresses below.
  225.  
  226. Have fun! (Easy, 'cause you own an Amiga!)
  227.  
  228.  
  229.   _            _              _
  230.  /_)          /_)          __// Hobby programmer...  Fido: 2:280/464.2
  231. / atrick van /_)eem        \X/  e-mail: patrick.van.beem@aobh.xs4all.nl
  232.  
  233. Postal address: Parlevinker 5
  234.                 2152 LC  Nieuw-Vennep
  235.                 The Netherlands
  236.  
  237.  
  238.  
  239. Nice detail: The latest version of the Microsof mouse driver for windows I
  240. installed on my PC consumed 1.6MB of harddisk space! I think I'll stick to
  241. my Amiga :-))
  242.